home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 September / PCWorld_2008-09_cd.bin / domacnost a kancelar / joomla / Joomla_1.5.4-Stable-Full_Package.exe / libraries / phputf8 / README < prev    next >
Text File  |  2008-07-06  |  4KB  |  86 lines
  1. ++PHP UTF-8++
  2.  
  3. Version 0.1
  4.  
  5. ++DOCUMENTATION++
  6.  
  7. Nothing yet, other than source code documentation. A tutorial on
  8. how to handle UTF-8 with this library is pending. You will find help at;
  9.  
  10. http://www.phpwact.org/php/i18n/charsets
  11. http://www.phpwact.org/php/i18n/utf-8
  12.  
  13. Important Note: DO NOT use these functions without understanding WHY
  14. you are using them. In particular, do not blindly replace all use of PHP's
  15. string functions which functions found here - most of the time you will
  16. not need to, and you will be introducing a significant performance
  17. overhead to your application. You can get a good idea of when to use what
  18. from reading: http://www.phpwact.org/php/i18n/utf-8
  19.  
  20. Important Note: For sake of performance most of the functions here are
  21. not "defensive" (e.g. there is not extensive parameter checking, well
  22. formed UTF-8 is assumed). This is particularily relevant when is comes to
  23. catching badly formed UTF-8 - you should screen input on the "outer
  24. perimeter" with help from functions in the utf8_validation.php and
  25. utf8_bad.php files.
  26.  
  27. Important Note: this library treats ALL ASCII characters as valid, including ASCII control characters. But if you use some ASCII control characters in XML, it will render the XML ill-formed. Don't be a bozo: http://hsivonen.iki.fi/producing-xml/#controlchar
  28.  
  29. ++BUGS / SUPPORT / FEATURE REQUESTS ++
  30.  
  31. Please report bugs to:
  32. http://sourceforge.net/tracker/?group_id=142846&atid=753842
  33. - if you are able, please submit a failing unit test
  34. (http://www.lastcraft.com/simple_test.php) with your bug report.
  35.  
  36. For feature requests / faster implementation of functions found here,
  37. please drop them in via the RFE tracker: http://sourceforge.net/tracker/?group_id=142846&atid=753845
  38. Particularily interested in faster implementations!
  39.  
  40. For general support / help, use:
  41. http://sourceforge.net/tracker/?group_id=142846&atid=753843
  42.  
  43. In the VERY WORST case, you can email me: hfuecks gmail com - I tend to be slow to respond though so be warned.
  44.  
  45. Important Note: when reporting bugs, please provide the following 
  46. information;
  47.  
  48. PHP version, whether the iconv extension is loaded (in PHP5 it's 
  49. there by default), whether the mbstring extension is loaded. The
  50. following PHP script can be used to determine this information;
  51.  
  52. <?php
  53. print "PHP Version: " .phpversion()."<br>";
  54. if ( extension_loaded('mbstring') ) {
  55.     print "mbstring available<br>";
  56. } else {
  57.     print "mbstring not available<br>";
  58. }
  59. if ( extension_loaded('iconv') ) {
  60.     print "iconv available<br>";
  61. } else {
  62.     print "iconv not available<br>";
  63. }
  64. ?>
  65.  
  66. ++LICENSING++
  67.  
  68. Parts of the code in this library come from other places, under different
  69. licenses.
  70. The authors involved have been contacted (see below). Attribution for
  71. which code came from where can be found in the source code itself.
  72.  
  73. +Andreas Gohr (author of Dokuwuki: http://splitbrain.org / 
  74. http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php) has
  75. given permission for functions he wrote to be released here and
  76. under the terms of the LGPL license.
  77.  
  78. Note: that this is potentially a problem (any clarification appreciated
  79. to hfuecks gmail com) - Dokuwuki is licensed under GPL so is Andi actually
  80. allowed to "downgrade" to LGPL?
  81.  
  82. +Henri Sivonen (http://hsivonen.iki.fi/php-utf8/ / 
  83. http://hsivonen.iki.fi/php-utf8/) has also given permission for his
  84. code to be released under the terms of the LGPL. He ported a Unicode / UTF-8
  85. converter from the Mozilla codebase to PHP, which is re-used in phputf8
  86.